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Document History 


Description Version 


Working Draft - addressed reorganization comments |09 108283 | 


First published version with transit, traffic, tolling, and 09/13/13 
parking APIs 


Update Traffic APIs’ structure information, parameters 
and filters, and their examples to sync with 5/2/2014 
specification provided on Open5 I l.org. 


Add GTFS-realtime Trip Updates and Vehicle 5/7/2014 
Positions, and their examples. 
Minor updates and corrections IEEE 5/28/2014 


Add sample request endpoint and parameters and 
filters tables for Section 3.14 and 3.15. Update 
қ ; : 6/12/2014 
references for resource endpoints with their exact 
URL. 


Minor updates to Section 3.14 and 3.15 HE 7/17/2014 


Split API specification document into sub docs for each 8/26/2014 
API domain 

Minor updates to remove Transit references DE 9/24/2014 
Removed APIs that are not planned to be developed IEEE 08/01/2017 
Updated to add road closure polyline 08/19/2018 


Updated to include splitting longer geometries into 
multiple 100 point Linestring. eee 


Updated to include extension to road and event 09/17/2019 
element. 
Updated ‘severity’ definitions 10/3/2019 
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This document focuses on data exchange APIs for the traffic event data. For a complete overview of 5 11 
Data Exchange, please refer to Open 51 Data Exchange Specifications — Overview document. The 
overview document covers: 


e General information about 511 Data Exchange 

е Different protocols and data feeds available through Open 51 I APIs 

e Standard Discovery API specifications. 

e Encodings and Protocols along with reference to standard documentation. 
e Technical Guidelines 


It is highly recommened that all users of Open 51 І Data Exchange review the information іп the 
Overview document. 


The core traffic data resources consist of traffic events. Open5 I | provides message structure and API 
endpoint for accessing these resources. Open5l I will also provide metadata/lookup information that 
can be used by consumers to filter and limit information during requests. 


2.1 API: Event 

The event resource provides information about various types of events within a jurisdiction. These can 
be active incident, scheduled construction/roadway work or public events which may or may not have 
an impact on traffic conditions. Consumers can request list of all the active events or they can use 
additional filters such as city, roads to restrict the results as per their needs and use case. 


The event structure is the main element of the events collection. Although an event should be 
considered as independent, it is possible that one major event (mainly construction) could be split 


across several events. Below is a message structure of Event. 


Mandatory/ T 


Mandatory | Selflink to the current resource 


A globally unique ID for the event, 
following the format jurisdiction-id/event-id. 
Mandatory For example, 511.0rg/8c3f2. 
The first segment ofthe event ID is the 
jurisdiction ID. The second segment is a 
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Mandatory 


Mandatory 


Mandatory 


Mandatory 


string ID that must be unique within its 
jurisdiction. It can contain the characters 
a-ZA-Z0-9 .-. The two segments are 
separated with a /. 


The event's self link is of course itself a 
globally unique ID, and it is a suggested 
practice to use the event ID in the event 
URL, but a separate ID field is included for 
user-friendliness. 


Status ofthe event. The status allows a 
client to determine if the current event 
should be considered as currently 
effective. Value list: 


- ACTIVE : The event should be 
considered as effective 

- ARCHIVED : The event should not be 
considered as effective 


Title of the event. Should be shorter than 


500 characters. 


Basic type of event. Value list 


- CONSTRUCTION : planned road work 
- SPECIAL EVENT : special events (fair, 
sport event, etc.) 

- INCIDENT : accidents and other 
unexpected events 

- WEATHER CONDITION : Weather 
condition affecting the road 

- ROAD CONDITION : Status ofthe road 
that might affect travelers. 


Severity of the event. Value list: 


MINOR: the event has very limited 
impact on traffic. 

MODERATE: the event will have a 
visible impact on traffic but travel delays 
and traffic queuing should be minimimal 
and local. 

MAJOR: the event will have an elevated 
impact on traffic and create noticeable 
traffic delays and traffic queuing, but on a 
local level. 

SEVERE: the event will have a 
significant impact on traffic and create 
severe traffic delays and traffic queuing on 
a large scale. 

UNKNOWN: the impact is unknown, for 
example in the case of an accident that 
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has been recorded without a precise 
description. 


Geographical information about the event. 
Geography Geospatial Mandatory | Can be Point, MultiPoint, LineString, 
MultiLineString, or Polygon. 


Multistring geometry for closure 
associated with an event. The individual 
LineStringMember represents affected 
segment of a road. For events that expand 
over non-contiguous road segments, for 
example a closure affecting both sides of 

closure geometry Geospatial Optional чення б сро 
continuous event, entire geometry тау be 
split into multiple LineStringMembers due 
to limitation on number of points that can 
be included in one line string. When this 
happens, end point of one line string will 
be the start point of the next line string. 


mt Mandatory | When the event was initially created. 
DateTi When the content of the event last 
Updated (UTC) - Mandatory | changed. Will be the same as created if no 
updates have occurred. 
schedule Indicates the dates and times when the 


Timezone to be used for this event, e.g. 
қ { ; America/Montreal. If not provided, the 

Timezones imezdig Optional event is assumed to be in the default 
timezone of its jurisdiction. 
But strongly recommended. 

РТ А Description of the event. Plain text 

Description ша Optional description of the event, the reason for the 
event and any other relevant information 
for travelers. 
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Collection of 
event_subtypes event_subtype 
elements 


— event_subtype Ей 


511 Data Exchange Specification — Traffic Event АР! 


Optional 


Optional 


List of values to provide more detail about 
the type of event. 


unknown 

Construction 
Emergency construction 
Scheduled roadwork 
Overnight roadwork 
Street sweeping 

Utility work 

Repaving 

Bridge work 

Drawbridge testing 
Guard rail repairs 

Tree trimming 

Mowing 

Watermain break repairs 
Long-term construction 
Weekend long construction 
Traffic signal repairs 
Overhead sign repair 
CCTV repairs 

Gas main repairs 

Tunnel washing 

CMS repairs 

Bridge painting 

Line striping 

Barrier repairs 

Deck work 

Bridge cable repairs 
FasTrak toll lane repairs 
Toll lane repairs 

Toll plaza repairs 

Crack sealing 
Expansion joint repairs 
Attenuator repairs 
Tunnel repairs 

Rock blasting 
Installation of fiber optics 
Renovation 

Structure repair 

Road widening 
Intersection improvements 
Drainage improvements 
Installation of sign structure 
Noise wall construction 
Installation of traffic monitoring systems 
Safety improvements 
Steel repairs 

Installation of conduits 
Installation of traffic management systems 
Culvert repairs 

Viaduct repairs 

Test message 

Seismic retrofit 
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Landscaping 

Grinding 

Electrical work 

Slide clean-up 

Slide repair 

Light pole repair 

Median Work 

Trench work 

Highway construction 

Paving 

Sound wall construction 

Roadwork 

Emergency lane closure 
Emergency road closure 

Pothole Repair 

unknown 

Severe traffic incident 

Oil spill 

Spill 

Hazmat spill 

Transit related incident 

Severe traffic alert 

Earthquake 

Landslide 

Flood 

Tornado 

Emergency road closure 

Unplanned demonstration 
Rollover-overturn-jackknife 
Non-vehicle fire-explosion 

Grass fire 

Fire 

Noncollision injury 

Chemical spill 

Diverted traffic TO westbound lanes 
Diverted traffic TO eastbound lanes 
Diverted traffic TO northbound lanes 
Diverted traffic TO southbound lanes 
Diverted traffic FROM westbound lanes 
Diverted traffic FROM eastbound lanes 
Diverted traffic FROM northbound lanes 
Diverted traffic FROM southbound lanes 
Collision with impact attenuator 
Collision with bridge structure 
Collision with guardrail 

Collision with concrete traffic barrier 
Collision with post 

Collision with pole or support 
Collision with culvert or ditch 
Collision with curb 

CHP at the scene 

Collision with fence 

Collision with wall 

Collision with fire hydrant 

Collision with shrubbery or bush 
Collision with tree 
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CHP enroute 

Collision with pavement surface 
irregularity 

Sigalert 

Accident 

Overturned truck 
Overturned tractor trailer 
Overturned vehicle 
Accident investigation 
Jack-knifed tractor trailer 
Split tractor trailer 
Separated tractor trailer 
Single vehicle accident 
Overheight tractor trailer 
Truck fire 

Bus fire 

Tractor trailer fire 
Vehicle fire 

Brush fire 

Building fire 

Fire department activity 
Police department activity 
EMS activity 

Disabled truck 

Disabled tractor trailer 
Disabled vehicle 
Disabled bus 
Emergency construction 
Roadwork 

Roving repairs 

Flooding 

Icing 

Fog 

Snow 

Wet pavement 

High winds 

Weather related 
Downed tree 

Downed wires 

Downed pole 

Nearby building collapse 
Debris 

Cargo spill 

Fuel spill 

Water main break 
Abandoned vehicle 
Heaw traffic 

Delays 

Power failure - toll plaza 
Signal problem 

Stuck drawbridge 

Stuck gates 

Drawbridge open 
Transformer fire 

Gas main break 

Injured animal 
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Demonstration 
Rubber necking 

Sun glare 

Special event 
Construction 
Unknown other 
Unknown other with information 
Accident with injuries 
Accident with property damage only 
Accident road closed 
Spinout 

Shifted plates 

Road collapse 
Marine-Boat traffic 
Residual delays 
Motorcycle accident 
Missing manhole cover 
Raised manhole 
Collapsed manhole 
Collapsed sewer grate 
Missing sewer grate 
Obstruction 

Test message 
Multi-vehicle accident 
Two vehicle accident 
Structure Fire 
Structure Collapse 
Stuck Crossing Gates 
Pothole 

unknown 

Baseball game 
Football game 
Basketball game 
Hockey game 
Soccer game 

Tennis tournament 
Golf tournament 
Circus 

Parade 

Fireworks 

Concert 

Street fair 

Fair 

Festival 

Awards ceremony 
March 

Race 

Racing 

Fleet week 

Special Event 

Boxing 

Movie-TV filming 
New years eve 
Skating 

Track and Field 
Marathon 
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VIP Visit 

Test Message 
Convention 
Conference 


Degree of certainty of the event. Should 
only be used for unplanned events (e.g. 
incidents, weather conditions and 
pavement conditions events). Value list to 
be confirmed. Could be 
observed/likely/possible/unknown. 
Certainty Optional 
Value list 


- OBSERVED 
- LIKELY 

- POSSIBLE 
- UNKNOWN 


This structure is used to group events 
together. In specific situations (for 
Collection of example complex construction projects), 
grouped events links Optional several events might be related together. 
This field should be used to point a related 
event. 


А ; Link pointing to another event resource 
Seed Optional related to the current event. 
or [кете | Optional Description of a detour route to avoid this 
event. 
Roads Collection of Optional List of roads affected by the current event. 
road elements One event can impact several roads. 
Collections of Optional Areas affected by the event 
area elements р у | 
Collection of Collection of attachments providing 
attachment Optional additional information about the event 
links (PDFs, images, etc.) 


Link to an attachment. While only the URL 
А І is mandatory, more information тау be 
— related Link Optional provided via type, length, title, and 
hreflang, with semantics as in Atom. 


Caltrans 

CHP 

TIC (511’s Traveler Information Center — 
used for special events) 


Road _structure 


source_type Enum Optional 
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The road data format is used to provide information about the road(s) affected by an event. The 
structure of road_affected is: 


Mandatory/ — 


Name of the road affected by the event. Ideally, 
road names should be formatted in accordance 

Free Text Mandatory | with national or regional standards, and the 
same road should be named consistently in 
different events. 


self / url Optional Link to the Road resource for this road. 


Mandatory if 'to' is provided. 
Approximate start point of the event on the road. 
It can be an intersection with another street or it 
can be a mileage indication. 

from Free text Optional This value should not be used to determine the 
exact start point since it can be an 
approximation. The geometry field should be 
considered as the reference for exact location. 
If no to field is provided, this field means 


Approximate end point of the event on the road. 
Free text Optional It can be an intersection with another street or it 
can be a distance indication. 


Whether the road segment is closed or not. 
Value list: 
- CLOSED (road closed in the given direction. 
Used when lane type = “All lanes”; and 
lane status = "blocked|closed") 

state Enum Optional - SOME LANES CLOSED (but the road 
remains open. Default value) 
- SINGLE LANE ALTERNATING (a single lane 
alternates between both directions of traffic. 
Used when roadway advisory = "One way traffic 
control in effect) 
- ALL LANES OPEN Used when lane type = 
"All lanes”; and lane status = “ореп”) 


Mandatory if state is provided. 

Direction of the road that is affected by the 
Enum Conditional one 

Value list: 
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-Eastbound 

-Eastbound and Westbound 
-Nortbound 

-Northbound and Southbound 
-Southbound 

-Westbound 


The type of lane(s) impacted by the event. 

At least 1 lane 

All lanes 

All lanes subject to 

All lanes temporarily 

Alternate lanes 

Center lane 

Center lanes 

Left lane 

Left lane and shoulder 

Left lanes 

Left shoulder 

Left and center lanes 

Lane 

Lanes 

Right lane 

Right lane and shoulder 

Right lanes 

Right shoulder 

Right and center lanes 

Right and left lanes 
impacted_lane_type | Enum Optional Sporadic lane 

Temporary lane 

Various lanes 

Bus lane 

Right lane and exit ramp 

Left lane and exit ramp 

Right lane and entrance ramp 

Left lane and entrance ramp 

FasTrak lanes 

FasTrak toll lanes 

Toll lanes 

Toll lane 

Carpool 

HOV 

2nd lane from the left 

3rd lane from the left 

Ath lane from the left 

Auxiliary Lane 

Center Divider 

Left Bore 

Off Ramp 

On Ramp 

Right Bore 


road advisà Еи ütiffénal A roadway advisory for the traveler. Can be 
= гу р combined with impacted_lane_type and 


Page |10 





(м) 511 Data Exchange Specification — Traffic Event API 


METROPOLITAN 
TRANSPORTATION 


COMMISSION 


lane_status to add further context. Example: 
Right lanes closed until 4 PM. 


until further notice 
until midnight 
until 12-30 AM 
until 1 AM 
until 1-30 AM 
until 2 AM 
until 2-30 AM 
until 3 AM 
until 3-30 AM 
until 4 AM 
until 4-30 AM 
until 5 AM 
until 5-30 AM 
until 6 AM 
until 6-30 AM 
until 7 AM 
until 7-30 AM 
until 8 AM 
until 8-30 AM 
until 9 AM 
until 9-30 AM 
until 10 AM 
until 10-30 AM 
until 11 AM 
until 11-30 AM 
until 12-30 PM 
until 1 PM 
until 1-30 PM 
until 2 PM 
until 2-30 PM 
until 3 PM 
until 3-30 PM 
until 4 PM 
until 4-30 PM 
until 5 PM 
until 5-30 PM 
until 6 PM 
until 6-30 PM 
until 7 PM 
until 7-30 PM 
until 8 PM 
until 8-30 PM 
until 9 PM 
until 9-30 PM 
until 10 PM 
until 10-30 PM 
until 11 PM 
until 11-30 PM 
Both levels 

2 mile back-up 
2 and a half mile back-up 
1 mile back-up 
1 and a half mile back-up 
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3 mile back-up 

3 and a half mile back-up 

4 mile back-up 

5 mile back-up 

6 mile back-up 

7 mile back-up 

8 mile back-up 

9 mile back-up 

10 mile back-up 

1 hour delay 

10 minute delay 

15 minute delay 

2 way traffic 

20 minute delay 

25 minute delay 

30 minute delay 

35 minute delay 

40 minute delay 

45 minute delay 

50 minute delay 

55 minute delay 

thru AM rush hour 

thru PM rush hour 

thru PM 

thru AM 

until noon 

Traffic is being diverted 
Expect delays 

Emergency vehicles enroute 
Emergency vehicles at the scene 
Emergency crews enroute 
Emergency crews at the scene 
Traffic advisory in effect 
Metering lights are on 
Metering lights are off 

Avoid the area 

One way traffic control in effect 
Consider using alternate routes 


affected 
blocked 

closed 

open 

remain closed 
remains closed 


Optional 


Provides locational context for the event. For 
examples, can be combined with from, to, and 
direction to pinpoint the approximate location of 
the event. Example: /-680 Northbound at EI 
Cerro Blvd. 


article Optional 


unknown 
approaching 
area of 

at 
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between 
east of 
from 

near 
north of 
ramp from 
ramp to 
south of 
before 

by 

past 
through 
under 
over 
into-out of 
ramps from 
ramps to 
entering at 
exiting at 
into 

out of 
bypassing 
after 

on 


Collection of The areas resource is a list of area items. Area 
area Optional is a geographical area: a city, district, 
elements neighbourhood, etc. 
Allowed only if state is 
SOME LANES CLOSED and direction is not 
lanes open Integer Optional ӨЗІН. 
Number of lanes іп the given direction remaining 
open during this event. 
Allowed only if state is 
SOME_LANES_CLOSED and direction is not 
lanes closed Integer Optional BØTER 
Number of lanes in the given direction closed 
during this event. 
Collection of 
; impacted_sy : Allows provision of information about other 
impacted Systems stem Optional systems that can be affected. 
elements 
Value list of systems: 
: А ROAD 
— impacted system | Enum Optional SIDEWALK 
BIKELANE 
PARKING 


TRANSPORTATION 


COMMISSION 
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Area structure 


Ma ndatory/ 


Mandatory Thenameofthearea. = name of the area. 
Unique identifier for the area from the 
Opent511 ID | Mandatory | GeoNames database, in the form of e.g. 
geonames.org/5323810. 
URL to a human-readable Web page with 
self Link Optional information about the area. Example 
http://geonames.org/{idV/ 


Restriction structure 


Mandatory/ E 


Type of restriction that affects vehicles. Value 
list: 

SPEED: Limitation of the speed of vehicles. 
Unit is in kilometers/hour. 

WIDTH: Width limitation, mainly for trucks. 

restriction type Enum Mandatory | Unit is meters. 

HEIGHT: Height limitation, mainly for trucks. 
Unit is meters 

WEIGHT: Weight limitation for vehicles. Unit 
is metric tons. 

AXLE WEIGHT: Weight limitation per axle for 
truck. Unit is metric tons. 








Value ofthe limitation. For example, a speed 
Value Float Mandatory | limitation of 60km/h will have a value of 60 with a 
restriction type set to SPEED 


Schedule structure 


The schedule defines timelines of an event. 
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recurring schedules 





— start_date 


Collection of 


recurring schedule 
elements 
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Conditional 


Mandatory 


— daily start time 


— daily end time 





— days 
exceptions 


collection of day 
elements 


Collection of 
exception elements 





Optional 


Conditional 
Optional 
Optional 


One (and only one) 
of recurring schedules or intervals is required 


The recurring schedule structure expresses repeating 
schedules, like "Every day starting December 4th", or 
"Mondays 9 to 11 from September 1 to October 30." An 
event can include 

multiple recurring schedule elements inside 


this recurring schedules tag; exception elements can 
override them. 


Mandatory in each recurring schedule 
Start date of this schedule. 


End date of the event. If a start date but no end date is 
provided, the schedule continues indefinitely. 


Daily start time of the event, as HH:mm, e.g. 13:00. 
Applies to each day in this recurring schedule . 


Mandatory if daily start time isprovided, not 
allowed otherwise 


Daily end time ofthe event, as HH:mm, e.g. 17:30. 
Applies to each day in this recurring schedule . 


Contains a day tag for every day ofthe week during 


which this recurring schedule is active. Days are 


indicated with an integer, with (following the ISO 
standard) Monday being 1 and Sunday 7. So, for an 
event active on Monday and Wednesday, 

«days» «day? 1«/day» «day» 3«/day»«/days». If omitted, 
the schedule is active every day between its start and 
end dates. 


if present, there mustbe 
a recurring schedules element (and no intervals ) 


Exceptions override recurring schedules. 
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— exception Custom time format 


Collection of 


intervals т 
2 interval elements 


Custom time format, 
largely a subset of 
IS08601 intervals 
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Mandatory 


Conditional 


Mandatory 


An exception provides the definitive schedule for a 
specific date. It overrides 
any recurring schedule information for that date. 


An exception ofthe form Y YYY-MM-DD indicates that 
this event is not in effect for the given date. 


An exception ofthe form Y YYY-MM-DD HH:mm- 
HH:mm indicates that, on that date, the event is in 


effect only between the provided start and end time. If 
there are multiple disjoint periods on that day, more 
than one start-end period can be included: Y YY Y-MM- 


DD HH:mm-HH:mm HH:mm-HH:mm . 


One (and only one) 
of recurring schedules or intervals is required 


Represent an event's schedule as a list of explicit 
periods. An event must use 
either recurring schedules or intervals , not both. 


If this contains more than one interval , their time 
periods may not overlap. This also implies that no more 
than one can omit an end time. 


Defines a specific period of time during which the 
schedule is in effect; two (without timezone 
offset) joined with a / . For example, a period from 9 
p.m. September 1 to 8 a.m. September 2 would 

be 2014-09-01T21:00/2014-09-02T08:00 . 


The second datetime, after the slash, may be omitted. 
So, to indicate a period from 9 p.m. September 1 until 
further notice, use: 2014-09-01T21:00/ 
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Sample request endpoint for events 





Request Type 


Request Endpoint 
Example For e.g. http://api.511.org/Traffic/Events 





Parameters and Filters supported with the request 


Parameter Mandatory/ | Description 
Optional 


format Optional The response format (json/xml) desired. If none specified, then default 
response would be JSON. 
e.g. 
?format=json 
(returns json respone for v1, if v1 is the latest version or specified via 
version parameter) 
?format=xml 
version Optional The version of Open511 desired. 
e.g 
?version=v1 
(returns response for v1 in conjunction with format requested. 


Mandatory | Unique key assigned to a user after they signup for Open511. 


Optional By default the API should only send active events. Supported values: 
ACTIVE Default value, returns only active events. 
ARCHIVED Returns only archived events 
ALL Retums both active and archived events. 


Optional Show only events that are, according to their schedules, in effect at a 
specific time, or during a specific time period. 
Can be either a single time, or a start and end time joined by a comma. 
The times must be complete ISO 8601 datetimes, with or without a 
timezone. 
Soto find, for example, all events in effect at some point on June 20th, 
you would ask for events between 00:00 and 23:59: 
in effect оп-2013-06-20Т00:00,2013-06-20Т23:59 
Or, to find events in effect within the next two hours, you'd get the current 
UTC timestamp — let's say it's 2013-06-20T17:40Z — and then request 
?in effect on-2013-06-20T17:40Z,2013-06-20T19:40Z. 
You can also use the special value ?in effect on=now to show events 
currently taking place. 
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severity Optional 


u 


geography Optional 


Е 
Ш i 


uu 
event subtype | Optional 


Д 
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If no timezone is provided, as in the first example, the server searches 
according to the local time as entered in the event. For example, if 
highways are closed for an hour at midnight on January 1st in both 
London and LA, ?in effect on-2014-01-01T00:00 would return both 
events (even though there's no single moment in time when the roads 
are closed in both cities), whereas the timezone-aware 

?іп effect on-2014-01-01T00:00Z would return only the London event. 


If this argument is not provided, the API should not perform any filtering 
based on the event schedules. 

Filter by the value of the severity field. OR queries are possible via a 
comma-separated list: ?severityz MINOR, MODERATE. 


Filter events by geographical bounding box. Four comma-separated 


coordinates, xmin, ymin, xmax, ymax. 


Filtering near a point or linestring. The geography value should be 


provided as a WKT string in WGS84 latitude/longitude. Example: 
...geography z POINT (-73.64 45.52). 
The geography must be used in conjuction with the tolerance filter. 


Provide a tolerance of radius in meters around if a POINT or 
LINESTRING is used as filtering parameter. For example 
...geography=POINT+(-73.64+45.52)&tolerance=50 would retrieve all the 


events within a circle of 50m radius around the selected point. 


The ID or URL of a jurisdiction, in order to show only events from a given 


jurisdiction. Use a comma-separated list to make OR queries. 
Example: jurisdiction-51 1.org. 


Filter events using the event type value list. Use a comma-separated list 


to make OR queries. 


Filter events using the event subtype value list. Use a comma-separated 


list to make OR queries. 
Filter events based on the creation date and time. 


This parameter can (and generally will) be preceded with one of the 
following operators: < <= > >=. These allow searches for events created 


before or after a supplied time, e.g. created=>2013-05-10T12:00Z. 
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updated Optional Filter events based on the last update timestamp. Accepts the same < <= 
> >= operators as created. 
Note: by default, the servers should only return ACTIVE events. When 
using the updated filter, in order to get events going from ACTIVE to 
ARCHIVED, the client must ask for all events: ...?status=ALL 

road_name Optional Shows only events containing a road element with the provided name. 
Case-sensitive exact match. Use a comma-separated list to make OR 
queries. 


Optional Shows only events containing a road element linking to a road element 
with the provided id. Use a comma-separated list to make OR queries. 


Optional Shows only events containing an area element with the provided id. Use 
a comma-separated list to make OR queries. 


Optional The maximum number of events to return in a single paginated 
response. 
The default value for this (i.e. how many items to include on a page if no 
limit parameter is provided) is up to individual implementors. Likewise, 
implementors may want to enforce a maximum value for this parameter 
in order to conserve server resources, so that a ?limit=10000 query 
would still return only e.g. 500 events per page. However, if such a 
maximum is implemented, it must not be lower than 500. 


The traffic event structure response for XML is shown in Appendix A Section А.Ї. Ї and for JSON is 
shown in Appendix B Section В.І. І. 





Possible Errors 


Listed below are HTTP status code and message returned for certain common errors: 


e 500- Internal Server Error (System has issues processing your request) 
e 401 — Unauthorized (Invalid API key) 


e 404 — Not found (If an individual event resource cannot be located). 
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3.1 Traffic XML 


A.1.1 Example Traffic Event Structure Response (XML 
<open511 
xmlns:gml-"http://www.opengis.net/gml" 
xml: lang="en" 
xml: base="http: //api. 511. org" 
version="v1" 
> 
<events> 
<event> 
<status>ACTIVE</status> 
«link rel="self" href="/traffic/events/511.0rg/149"/> 
«link rel="jurisdiction" href="http://api.511.org/jurisdictions/511.org/"/> 
<id>511. org/149</id> 
<headline>CHP : Accident on CA-160 Northbound between Main St (Antioch) and Antioch 
Bridge - Toll Plaza (Oakley). All lanes closed. Expect delays. 
</headline> 
«event type»INCIDENT«/event type» 
«event subtypes» 
«event subtype»Accident«/event subtype» 
«/event subtypes» 
«severity»UNKNOWN«/ severity» 
«created»2014-05-01T19: 28:31Z«/created» 
«updated»2014-05-01T19: 28:31Z«/updated» 
«geography» 
«gml:Point srsName="EPSG:4326"> 
«gml:coordinates»-121.75382399999999,38.004908« /gml : coordinates» 
</gml:Point> 
</geography> 
<roads > 
<road> 
«пате» СА -160« /name> 
«from»Main St«/from» 
«to»Antioch Bridge - Toll Plaza«/to» 
<direction>NorthBound</direction> 
<state>Closed</state> 
«lane type xmlns:gml-"http://www.opengis.net/gml" xmlns="http://511.org/open511- 
extensions"» 
All lanes 
«/lane type» 
«road advisory xmlns:gml-"http://www.opengis.net/gml" xmlns="http://511. org/open511- 
extensions"» 
Expect delays«/road advisory» 
«lane status xmlns:gml-"http://www.opengis.net/gml" xmlns="http://511.org/open511- 
extensions"» 
closed«/lane status» 
«article xmlns:gml-"http://www.opengis.net/gml" xmlns="http://511.org/open511- 
extensions"» 
between 
«/article» 
«/road» 
«/roads» 
«areas» 
«area» 
«name»Antioch«/name» 
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<id>geonames. org/5324200</id> 
«link rel="self" href="http: //geonames .org/5324200/" /» 
</area> 
<area> 
<name>Oak ley< /name> 
<id>geonames. org/5378566</id> 
«link rel="self" href="http: //geonames .org/5378566/" /» 
</area> 
</areas> 
<schedules> 
<schedule> 
«start date»2014-05-01«/start date» 
«/ schedule» 
«/ schedules» 
«/event» 
«event» 
<status>ACTIVE</status> 
«link rel="self" hrefz"/traffic/events/511.0rg/209" /» 
«link rel="jurisdiction" href-"http://api.511.0rg/jurisdictions/511.0rg/"/» 
«id»511.0rg/209«/id» 
«headline»CHP : Obstruction on US-101 N NorthBound before Coyote Creek Golf Dr (San 
Jose) left lane blocked Expect delays«/headline» 
«event type»INCIDENT«/event type» 
«severity»UNKNOWN«/severity» 
«created»2014-05-02T01: 13:55Z«/created» 
«updated»2014-05-02T02:43:16Z«/updated» 
«geography» 
«gml:Point srsName="EPSG:4326"> 
«gml:coordinates»-121.69346399999999,37.19068«/gml1: coordinates» 
</gml:Point> 
</geography> 
<roads > 
<road> 
«name»US -101 N</name> 
«from»Coyote Creek Golf Dr</from> 
«to/» 
<direction>NorthBound</direction> 
<state>Open</state> 
</road> 
</roads> 
<schedules> 
<schedule> 
«start date»2014-05-01«/start date» 
«/ schedule» 
«/ schedules» 
«closure geometry xmlns:gml-"http://www.opengis.net/gml" xmlns-"http://511.0rg/open511- 
extensions"» 
«gml:MultiLineString srsName-"urn:ogc:def: crs: EPSG: :4326" > 
<gml:LineStringMember > 
«gml:LineString» 
<gml:posList> 
-121 .9054037 78982 ,37. 4664031808211, -121.9055169997 24, 37 .46654200002 84, - 
121. 905530999967 , 37 .4665599997276, -121 .9805550000234 ,37. 4665840000328, - 
121. 905665999687 , 37 .4667269999391, -121.906012000191,37. 4671670002383, - 
121.906404999653, 37 .4676470002688, -121 .906715000173 ,37. 4680369998512, - 
121.907135000298, 37 .46853 800016 28, -121 .907 393999865 ,37. 4688380001212, - 
121.907569999593, 37 .46905 80000859, - 
121.907808999967,37.4693440001416 , 121. 938268000236 , 37 .512444999755, - 
121. 938432000268 , 37 .512730000037, -121. 938663000246, 37 .5131339997496, - 
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121. 93890799957, 37.5135559999043, -121. 939175000432, 37 .51402 2000349, - 
121. 939356000182, 37 .5143290001285, -121.939525000237,37. 5146310001649, - 
121. 939581665124, 37 .5147344758693 
</gml:posList> 
«/gml:LineString» 
</gml: LineStringMember> 
<gml:LineStringMember> 
<gml:LineString> 
<gml:posList> 
-121 .94146 8948045 , 37. 5310149698319, -121.9413 38999731, 37 .53109 7000203, - 
121. 9412659999 36, 37 .53114099990 76, -121 .941188999943 ,37. 5311869999595, - 
121. 941030999759 , 37 .53128000016 38, -121 .940669000259 ,37. 5314930001716, - 
121.940090999951, 37 .53181600002 29, -121 .939761000238 ,37. 5319949996535, - 
</gml:posList> 
«/gml:LineString» 
</gml: LineStringMember> 
<gml:LineStringMember> 
<gml:LineString> 
<gml:posList> 
-121.885072507042,37.574436747037 , -121.885018000099,37. 5744620003296, - 
121.884722999648, 37 .5745870001079, -121.884567999837,37.5746469998415, - 
121.884411000377,37.5747040000065 , -121 .884217000208 ,37. 5747680001896, - 
121.88396199994, 37. 5748509998558, - 121. 883647000295 , 37.5 749509997424, - 
121. 883442000256, 37 .5750149997133, -121 .882085999623 ,37. 5754569997014, - 
121.8815459998 48 , 37 .5756320001267, -121.88146600038 , 37 .5 756530000647 , - 
121.8807 71999721 , 37 .5758790003444, -121.880544000115 ,37. 5759670002614, - 
121. 88040299965, 37.5760220002457, - 121. 880283999824 , 37 .576072999716, - 
121. 8801990003 34, 37 .5761110002897, -121 .88007 7000135 ,37. 5761699999243, - 
121. 879953000286, 37 .5762310001006, -121.879832999737,37.5762890000585, - 
121.879713999912,37.5763520000107 , -121 .879580000017 ,37.5764280001421 
</gml:posList> 
«/gml:LineString» 
«/gml:LineStringMember» 
</gml:MultiLineString> 
</closure_geometry> 
«source name xmlns:gml-"http://www.opengis.net/gml" xmlns="http://511.org/open511- 
extensions"» 
CHP 
«/source name» 
«source id xmlns:gml-"http://www.opengis.net/gml" xmlns="http://511.org/open511- 
extensions"» 
1234 
«/source id» 
</event> 
</events> 
<pagination> 
<of fset >0</offset> 
<link rel="next" href="/traffic/events/?api Кеу= {арі key)&limit=2&amp;offset=2"/> 
</pagination> 
«link rel="self" href="/traffic/events/?api_key={api_key }&limit=2&amp ;offset=0"/> 
<link rel="up" href="/"/> 
«/open511» 
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4.1 Traffic JSON 


В.І.І Example Traffic Event Structure Response (JSON 
{ 
"events": [{ 
"url": "/traffic/events/511.0rg/149", 
"jurisdiction url": "http://api.511. org/jurisdictions/511.org/", 
"id": "511.0rg/149", 
"status": "ACTIVE", 
"headline": "CHP : Accident on CA-160 Northbound between Main St (Antioch) and 
Antioch Bridge - Toll Plaza (Oakley). All lanes closed. Expect delays", 
"event type": "INCIDENT", 
"event subtypes": [ 
“Accident” 
1» 
"severity": "UNKNOWN", 
"created": "2014-05-01T19:28:31Z", 
"updated": "2014-05-01T19:28:31Z", 
"geography": { 
"type": "Point", 
"coordinates": [ 
-121.753824, 
38.004908 


"name": "CA-160", 
"from": "Main St", 
"to": "Antioch Bridge - Toll Plaza", 
"direction": "NorthBound", 
"state": "Open", 
"+lane type": “All Lanes", 
"+article": "between", 
"+road advisory": “Expect delays", 
«+1апе status" : “closed” 
71, 
"areas": [ 
{ 
"url": "http: //geonames.org/5324200/", 
"name": "Antioch", 
"id": "geonames.org/5324200" 


"url": "http: //geonames.org/5378566/", 
"name": "Oakley", 
"id": "geonames.org/5378566" 


} 


Мерей ан [1 
"start date": "2014-05-01" 
71, 
"+source_id": “1234”, 
"+source_name": “CHP”, 
"+closure geography": { 
"type": "MultiLineString", 
"coordinates": 
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[ 
[ 


-121.965344339091, 


38.0227069562185 
1, 
[ 


-121.965265000299, 


38.0226909996807 
]; 


[ 


-121.964901000251, 


38.0226219996731 
]; 


[ 


-121.963347999975, 


38.0223280002051 
]; 


[ 


-121.963122999844, 


38.0222860001848 
1, 
Ї 


-121.962568, 


38.0221690001024 
]; 


[ 


-121.962037000446, 


38.0220539997063 
]; 


[ 


-121.961545000351, 


38 .02195 800007 43 
1, 


[ 


-121.960780000445, 


38.0218160002701 
]; 


[ 


-121.960453000207, 


38.0217570002606 
]; 


[ 


-121.960274000107, 
38.0217250000316 


"url": "/traffic/events/511.0rg/209", 


"jurisdiction url": "http://api.511. org/jurisdictions/511.org/", 
"id": "511.0rg/209", 
"status": "ACTIVE", 


"headline": "CHP : 


Obstruction on US-101 N NorthBound before Coyote Creek 
(San Jose) left lane blocked Expect delays", 

"event type": "INCIDENT", 

"severity": "UNKNOWN", 


Golf Dr 
"created": "2014-05-02T01:13:55Z", 
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"updated": "2014-05 -02Т02 :43:161", 
"geography": { 
"type": "Point", 
"coordinates": [ 
-121 .693464, 
37 .19068 
] 
}› 
"roads": [{ 
"name": "US-101 N", 
"from": "Coyote Creek Golf Dr", 
"EOS ME, 
"direction": "NorthBound", 
"state": "Open" 
il 
"schedules": ГІ 
"start date": "2014-05-01" 
1] 
j 
1, 
"pagination": 1 
"next url": "/traffic/events/?api key=(api key)&limit=2&0ffset=2", 
"offset": 0 


"url": "traffic/events/?api key-(api keyj&limit-2&offset-0", 
"up url": "/", 
"version": "v1" 
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